Node / meshtastic / Meshtastic-Android / files / core / ui / src / commonMain / kotlin / org / meshtastic / core / ui / component / BuildNodeDescription.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.core.ui.component

Tff7b72import T7ee787androidx.compose.runtime.Composable

Tff7b72import T7ee787androidx.compose.runtime.Immutable

Tff7b72import T7ee787org.jetbrains.compose.resources.stringResource

Tff7b72import T7ee787org.meshtastic.core.common.util.DateFormatter

Tff7b72import T7ee787org.meshtastic.core.resources.Res

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_battery

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_distance_away

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_favorite

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_hops_away

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_last_heard

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_offline

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_online

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_role

Tff7b72import T7ee787org.meshtastic.core.resources.a11y_node_signal

Tff7b72import T7ee787org.meshtastic.core.resources.now

Tff7b72import T7ee787org.meshtastic.core.resources.unknown

Tff7b72import T7ee787org.meshtastic.core.ui.util.formatAgo

Tff7b72import T7ee787org.meshtastic.proto.Config.LoRaConfig.ModemPreset

Tff7b72private Tff7b72const Tff7b72val Te6edf3MILLIS_PER_SECOND Tff7b72= T79c0ff1T79c0ff0T79c0ff0T79c0ff0L

Tff7b72private Tff7b72const Tff7b72val Te6edf3MAX_BATTERY_PERCENT Tff7b72= T79c0ff1T79c0ff0T79c0ff0

T8b949e/** Pre-resolved localized strings for TalkBack node descriptions. */

Tf0883e@Immutable

Tff7b72internal Tff7b72data Tff7b72class T56d364NodeDescriptionStringsTb4b4b4(

Tff7b72val Te6edf3onlineTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3offlineTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3favoriteTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3lastHeardTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3roleTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3hopsAwayTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3batteryTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3distanceAwayTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3signalTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3unknownTb4b4b4: Tffa657StringTb4b4b4,

Tff7b72val Te6edf3nowTb4b4b4: Tffa657StringTb4b4b4,

Tb4b4b4)

T8b949e/** Resolves [NodeDescriptionStrings] from Compose string resources. */

Tf0883e@Composable

Tff7b72internal Tff7b72fun Td2a8ffrememberNodeDescriptionStringsTb4b4b4(Tb4b4b4)Tb4b4b4: Te6edf3NodeDescriptionStrings Tff7b72= Te6edf3NodeDescriptionStringsTb4b4b4(

Te6edf3online Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_onlineTb4b4b4)Tb4b4b4,

Te6edf3offline Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_offlineTb4b4b4)Tb4b4b4,

Te6edf3favorite Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_favoriteTb4b4b4)Tb4b4b4,

Te6edf3lastHeard Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_last_heardTb4b4b4, Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3role Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_roleTb4b4b4, Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3hopsAway Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_hops_awayTb4b4b4, T79c0ff0Tb4b4b4)Tb4b4b4,

Te6edf3battery Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_batteryTb4b4b4, T79c0ff0Tb4b4b4)Tb4b4b4,

Te6edf3distanceAway Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_distance_awayTb4b4b4, Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3signal Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3a11y_node_signalTb4b4b4, Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4)Tb4b4b4,

Te6edf3unknown Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3unknownTb4b4b4)Tb4b4b4,

Te6edf3now Tff7b72= Te6edf3stringResourceTb4b4b4(Te6edf3ResTb4b4b4.Te6edf3stringTb4b4b4.Te6edf3nowTb4b4b4)Tb4b4b4,

Tb4b4b4)

T8b949e/** Builds a TalkBack-friendly description aggregating node state. Shared between [NodeItem] and [NodeItemCompact]. */

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffLongParameterListTa5d6ff"Tb4b4b4)

Tff7b72internal Tff7b72fun Td2a8ffbuildNodeDescriptionTb4b4b4(

Te6edf3nameTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3isOnlineTb4b4b4: Tffa657BooleanTb4b4b4,

Te6edf3isFavoriteTb4b4b4: Tffa657BooleanTb4b4b4,

Te6edf3lastHeardTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3roleTb4b4b4: Tffa657StringTb4b4b4,

Te6edf3hopsAwayTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3batteryLevelTb4b4b4: Tffa657Int?Tb4b4b4,

Te6edf3distanceTb4b4b4: Tffa657String?Tb4b4b4,

Te6edf3snrTb4b4b4: Tffa657Float?Tb4b4b4,

Te6edf3viaMqttTb4b4b4: Tffa657BooleanTb4b4b4,

Te6edf3stringsTb4b4b4: Te6edf3NodeDescriptionStringsTb4b4b4,

Te6edf3lastHeardIsRelativeTb4b4b4: Tffa657Boolean Tff7b72= Tff7b72trueTb4b4b4,

Te6edf3modemPresetTb4b4b4: Te6edf3ModemPreset? Tff7b72= Tff7b72nullTb4b4b4,

Tb4b4b4)Tb4b4b4: Tffa657String Tff7b72= Te6edf3buildString Tb4b4b4{

Te6edf3appendTb4b4b4(Te6edf3nameTb4b4b4)

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Tff7b72if Tb4b4b4(Te6edf3isOnlineTb4b4b4) Te6edf3stringsTb4b4b4.Te6edf3online Tff7b72else Te6edf3stringsTb4b4b4.Te6edf3offlineTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3isFavoriteTb4b4b4) Tb4b4b4{

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3favoriteTb4b4b4)

Tb4b4b4}

Tff7b72if Tb4b4b4(Te6edf3lastHeard Tff7b72> T79c0ff0Tb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3timeText Tff7b72=

Tff7b72if Tb4b4b4(Te6edf3lastHeardIsRelativeTb4b4b4) Tb4b4b4{

Te6edf3formatAgoTb4b4b4(Te6edf3lastHeardTb4b4b4, Te6edf3stringsTb4b4b4.Te6edf3unknownTb4b4b4, Te6edf3stringsTb4b4b4.Te6edf3nowTb4b4b4)

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3DateFormatterTb4b4b4.Te6edf3formatDateTimeTb4b4b4(Te6edf3lastHeardTb4b4b4.Te6edf3toLongTb4b4b4(Tb4b4b4) Tff7b72* Te6edf3MILLIS_PER_SECONDTb4b4b4)

Tb4b4b4}

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3lastHeardTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4, Te6edf3timeTextTb4b4b4)Tb4b4b4)

Tb4b4b4}

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3roleTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4, Te6edf3roleTb4b4b4)Tb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3hopsAway Tff7b72> T79c0ff0Tb4b4b4) Tb4b4b4{

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3hopsAwayTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff0Ta5d6ff"Tb4b4b4, Te6edf3hopsAwayTb4b4b4.Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Te6edf3batteryLevelTff7b72?.Te6edf3let Tb4b4b4{

Tff7b72if Tb4b4b4(Tffa657it Tff7b72in T79c0ff1.Tb4b4b4.Te6edf3MAX_BATTERY_PERCENTTb4b4b4) Tb4b4b4{

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3batteryTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff0Ta5d6ff"Tb4b4b4, Tffa657itTb4b4b4.Te6edf3toStringTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Te6edf3distanceTff7b72?.Te6edf3let Tb4b4b4{

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3distanceAwayTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4, Tffa657itTb4b4b4)Tb4b4b4)

Tb4b4b4}

T8b949e// Rated from SNR alone: RSSI cannot indicate demodulability without the noise floor, and the old `rssi < 0` gate

T8b949e// suppressed the announcement for a genuine 0 dBm reading.

Tff7b72if Tb4b4b4(Te6edf3hopsAway Tff7b72=Tff7b72= T79c0ff0 Tff7b72&Tff7b72& Tff7b72!Te6edf3viaMqtt Tff7b72&Tff7b72& Te6edf3snr Tff7b72!Tff7b72= Tff7b72nullTb4b4b4) Tb4b4b4{

Tff7b72val Te6edf3quality Tff7b72= Te6edf3determineSignalQualityTb4b4b4(Te6edf3snrTb4b4b4, Te6edf3modemPresetTb4b4b4)

Te6edf3appendTb4b4b4(Ta5d6ff"Ta5d6ff, Ta5d6ff"Tb4b4b4)

Te6edf3appendTb4b4b4(Te6edf3stringsTb4b4b4.Te6edf3signalTb4b4b4.Te6edf3replaceTb4b4b4(Ta5d6ff"Ta5d6ff%sTa5d6ff"Tb4b4b4, Te6edf3qualityTb4b4b4.Te6edf3nameTb4b4b4.Te6edf3lowercaseTb4b4b4(Tb4b4b4)Tb4b4b4)Tb4b4b4)

Tb4b4b4}

Tb4b4b4}